home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 4 / Precision Software Applications Silver Collection Volume 4 (1993).iso / stats / chadyn.exe / READ.ME < prev    next >
Text File  |  1989-09-15  |  7KB  |  156 lines
  1.     
  2.                 SEPTEMBER 1989
  3.  
  4. Colleagues and students:
  5.  
  6.                 RECENT MODIFICATIONS IN DYNAMICS
  7.  
  8.     Writing a program like DYNAMICS means making hundreds 
  9. of small decisions, and making hoardes of modifications to 
  10. ensure the parts work together smoothly and naturally. 
  11. One problem is to set up menus so that the user can find the 
  12. desired command, and there are many commands, so the less 
  13. essential commands should be buried more deaply in the 
  14. hierarchy of submenus. A continuing problem will be to make 
  15. sure the UNIX/X11 version is as easy to use as the MS-DOS 
  16. version.
  17.  
  18.     Since the January 1988 version, the speed of the 
  19. numerically intensive parts has been sped up by a factor 
  20. of five due to a better compiler, and the program adapts 
  21. to the resolution appropriate for range of screens, and I 
  22. have included color graphics, and have found ways to make 
  23. color graphics useful. 
  24.  
  25.     To make full use of 16 colors on EGA or VGA screens,
  26. you must have 640 KB memory, though the program should 
  27. run with 320 KB. See problem 1 below. The pictures can be 
  28. stored in color on disk, usually in less space than the 
  29. monocrome version reqired. 
  30.  
  31.     The menus have been reworked with the goal of 
  32. putting simpler information in front of the user by user 
  33. more menus. As a result some of the documentation is 
  34. inaccurate in the description of the menus. The command 
  35. descriptions are however hopefully correct. If a command 
  36. that you want is not in the menu, then try it anyway. It 
  37. is probably still there.
  38.  
  39.     Documentation has been updated drastically, and that 
  40. process has not been finished. The disk(s) you receive may 
  41. have a file called MANUAL.DOC which is the partially revised 
  42. version. The new version includes more examples. There are 
  43. details on how to change the maps and differential equations 
  44. (though you must have a Microsoft C compiler for MS-DOS 
  45. machines). There is a file UNIX.DOC which desribes how 
  46. to proceed if you have a UNIX/X11 workstation.
  47.  
  48.     The stable and unstable manifold routines 
  49. (introduced mainly in the summer of 1988) have 
  50. been made more robust as a result of a great deal of 
  51. detailed study. The straddle orbit routines have been 
  52. revised about once a month since H. Nusse and I now have 
  53. algorithms that are both efficient and  (in nice cases) 
  54. rigorously justifiable. These stable and unstable routines 
  55. and straddle routines and basin routines are quite basic 
  56. to dynamics would be reasonable material for sophomore 
  57. dynamics courses. 
  58.  
  59.     In the past couple months, I have included routines 
  60. for following periodic orbits as parameters are varied; this 
  61. should be one of the more useful features of the program. 
  62. Currently it works only when the system has 2 dimensional 
  63. phase space, but there is no real difficulty in upgrading 
  64. the code so that it works in n dimensions. 
  65.  
  66.     There is now a variable step fifth order Runge-Kutta
  67. solver for situations where it is important to control the 
  68. local error in solving the differential equations. 
  69.  
  70.     There is more ability to let the axes be parameters 
  71. of the system. For example, both coordinates of the Mandelbrot 
  72. set are parameters, and other than that, it is just an 
  73. application of the basin routines. You can use the small cross 
  74. to select a box and create a blowup, just as if the axes were 
  75. coordinates of y[].
  76.  
  77.         UNIX COMPUTERS
  78.  
  79.     Eric Kostelich has put a great deal of effort to 
  80. make the source code compatible with UNIX. The UNIX 
  81. version still has some minor rough spots. It has not been 
  82. thoroughly tested. It is set up to work in two windows, 
  83. one a text window for commands and one a graphics window. 
  84. The mouse is used only for pointing to a window. It must 
  85. point to the graphics window to recognize the keyboard. 
  86. See file UNIX.DOC.
  87.  
  88.  
  89.         KNOWN BUGS AND PROBLEMS
  90.  
  91.     The program uses 568KB memory to provide 
  92. full color graphics. If your computer has lots of drivers 
  93. or memory resident programs installed, even 640 KB may not 
  94. be enough.  While the program checks to see how 
  95. much memory is available, the operating system seems to 
  96. misinform the program in some cases, not detecting these 
  97. extra files in memory. If the screen refresh 
  98. (interrupt 'r') is putting lots of irrelevant garbage on 
  99. the screen, your problem may be just this situation. This 
  100. problem can be cured (in those cases found so 
  101. far) by using a different autoexec.bat file and possibly a 
  102. different config.sys for rebooting the computer so as to 
  103. eliminate some of the files and routines that are 
  104. ordinarily kept in memory.
  105.  
  106.  
  107.         GOALS FOR THE PROGRAM
  108.  
  109.     The goal is not to finish the program but to have 
  110. a program that can be extended by the users. Since it is 
  111. constantly undergoing change, bugs can creep into places 
  112. that were bug free. Please report all problems with as 
  113. much detail as possible, including the detailed 
  114. circumstances. I would also like recommendations for 
  115. changes.  I expect it to be published somewhere, hopefully 
  116. by September 1991. (at low cost). People getting this 
  117. version are acting as testors, and their comments would be 
  118. helpful, though please do not expect a direct response. 
  119.  
  120.     Computer programs for studying nonlinear dynamics 
  121. have been advertised for $600. I view this program 
  122. differently, as a package of ideas that I want to make 
  123. available to the scientific community, to as many students 
  124. and faculty and scientists as possible. I cannot give help 
  125. in individual cases. I view this package of programs and 
  126. documentation as the equivalent of a research publication 
  127. and I would like to request that papers that use it should 
  128. acknowledge it as a publication. Others will then learn 
  129. about it and will be able to benefit from its use. 
  130. Acknowledgements to the program should be in the the 
  131. references section and referred to as a book would be. For 
  132. example,
  133.  
  134. J.A. Yorke, DYNAMICS, A PROGRAM FOR IBM PC CLONES, 
  135. University of Maryland, College Park, 1989.
  136.  
  137.     Several scientists have told me that it is stupid 
  138. to make the source code available, but I hope that they 
  139. miss the point. I will permit parts of the source code to 
  140. be included free of charge in other programs provided 
  141. permission is obtained in writing from me and provided 
  142. acceptable acknowledgements of authorship and copywrites 
  143. are included in the new program. I also look foreward to 
  144. others writing modules for inclusion in the program, with 
  145. acknowlegements of course. In the next version more 
  146. documentation will be available for those who want to 
  147. adapt the program to very different kinds of projects. For 
  148. the moment, peruse all the .DOC files included. 
  149.  
  150.  
  151.                 
  152.  
  153.                 James A. Yorke
  154.  
  155.  
  156.